home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d19
/
sm1d083.arc
/
SM1.DOC
< prev
next >
Wrap
Text File
|
1989-04-08
|
10KB
|
205 lines
-------------------------------------------
SM1 New User Registration DOOR version 0.83
by DJ Chuang
-------------------------------------------
SM1 is named for being the first door out of Southern Maryland.
This is a simple registration door for PCBoard 14.x sysops to
assure that the users fills out a script questionnaire. This is to
allow the sysop control of what questions get answered by the user,
and upon answering the questions, give them access to the BBS. The
user is displayed a number of sysop defined screens describing the
rules of using the BBS, which will not be abortable by the user.
* SM1 features:
o Custom script questionnaire, very similar to the main board's
o Force minimum chars response, if desired, on a per question basis
o User is upgraded to new security level upon questionnaire completion
o Optional visiting sysop questionnaire
o BBS rules text files are displayed to the users, who must agree to
the terms of each to complete their registration upgrade. Unlike
the old "read bulletins then do the script questionnaire", the rules
text files are displayed to the user one screen at a time, but are
not abortable via the PCBoard/ProKit "more?" prompt.
* Quick Installation:
This is a Prokit door. Simple to setup.
You must have a configuration file to use this door. The contents of
the configuration file are: (filename SM1.CNF)
INTERRUPT <- ProKit parameter. INTERRUPT, BIOS, or PCBTRAP
10 <- new user security level after completing questionnaire
50 <- new visiting sysop sec. level after sysop questionnaire
3 <- how many text files to show to user? (minimum: 1)
WELCOME <- first screen to show, always shown, welcome scrn to door
RULES1 <- rules text filenames follow, one per line.
RULES2
And in your PCBoard system directory, the batch file to execute this
door should be something like: (filename SM1)
ECHO OFF
CD \PCB\SM1
SM1 SM1.CNF C:\PCB
CD \PCB
BOARD
Then add the SM1 entry in your DOORS.DAT using PCBSETUP. Setup a separate
BRDMx and BRDMxG main menu screen in your \PCB\GEN directory for your new
users, so they will know which DOOR to open for registration and get
registered using SM1. You might even go so far as disabling all commands
on the main menu to the brand-new users who have a security level set in
the PCBSETUP new user level. They get their menu, and know they have to
type DOOR 8 (or whatever). Nothing else will happen for them, less
confusing (maybe).
Then you have to generate some script questionnaires, which works in a
very similar fashion as the PCBoard script questionnaires; with one
exception - and that is NO five-line header. (PCBoard questionnaires
require a five-line header before the questions list). Extra options
are described in the technical portion of this document. SCRIPT1 is
required in the SM1 working directory, and will be applied to all users
entering SM1 door. SCRIPT2 is optional. If it exists, it will be applied
to users who are visiting sysops.
NOTE: In your PWRD file, for brand new users, give them the same download
bytes per day as you would if they have full access. But disable
the download command for new users. This is necessary because this
door only upgrades the user's security level and nothing else.
(what happens is if a brand new user signs on with 0 downloadable
bytes, after using SM1 door, he may have a new security level to do
more commands, but he will still have 0 bytes to download).
PCBoard doesn't expect users to have security level changes.
A future version may actually check your PWRD file, depending on
response to this door.
* Technical information:
- Graphics version of texts
Text files may have ANSI graphics version, in the same manner that
PCBoard bulletins and directories and menus can have graphics version.
If your first screen is WELCOME, then WELCOMEG will be the graphics
version. The graphics version of any file are optional. If it's there
in the working directory, it will be displayed to the user, otherwise
the regular text file will be displayed.
- To display lots of rules text files
The number in line 4 of your configuration determines how many rules
text files will be shown to the user. The first one of this text files
list is meant to be a welcome screen. The rest of them are rules, and
will be shown to the user one at a time, making sure they agree to each
text file of rules. The screen will automatically pause every 23 lines,
but are not abortable. (it isn't a MORE prompt where the user could say
No and skip reading the important rules and disclaimers).
- What happens to the new user
The user will be greeted by the first screen in the configuration list
of text files. This should be a welcome screen of sorts to let the user
know they're about to read the rules to the BBS and will answer some
questions after reading the rules. After SM1 shows the user your
welcome screen, the user is asked if he wishes to register. This is
just in case a user stumbles into this door when he already has full
board access. (no harm will come to those who decide to thru with the
questionnaires anyways).
The next text files (which should be rules) will be displayed to the
user. After each text file, the prompt "Do you agree with the above"
will be shown to the user, upon which they must type "Y" to affirm.
Otherwise, the door will dump the user back to the BBS without an upgrade.
After the rules text files are displayed, the door will search the working
directory for filename SCRIPT1. The format for this questionnaire is
just like PCBoard's script questionnaires, except there is NO five-line
header. You may have multi-line questions displayed to the user by having
a ; (semicolon) in the first column. Each line of the SCRIPT1 file is
a question (except for the comment lines, which are just displayed to the
user when a semicolon is in column 1). And the user is to respond to the
question with up to a 70-character response. A ruler bar marked off at
10-characters is shown with each question.
The user will answer the questionnaire and the door will upgrade the
user's security level to what is in line 2 of the configuration file.
If the user has a security level greater than the upgrade security level,
nothing will be changed.
Then if SCRIPT2 exists in the working directory, the user is asked if
he is a sysop. If he answers affirmatively, then the second questionnaire
will applied to the user. Upon completion, the user is granted the
security level in line 3 of the configuration file. Line 3 may be
zero'd out if you don't have a 2nd script questionnaire for visiting sysops.
But line 3 may not be deleted (still needs to be there for a placeholder).
All the user answers will be logged to a file named SM1.LOG . The
question and answer session is topped with the user's name, city/state,
and phone numbers. In addition, SM1SYSOP.LOG will log answers from just
the second (visiting sysops) questionnaire. This is for those who wish
to keep a log of sysop's who call your BBS. Just delete SM1SYSOP.LOG
in your door batch file if you don't wish to keep this information.
Both questionnaire answers are still logged entirely in SM1.LOG.
SM1 script questionnaires have one additional option. If you wish to
require a question to be responded with a minimum length response from
the user, prefix the question with a two-digit number plus a colon.
The door will re-prompt for a response when the user fails to leave a
response that is long enough. For example:
10:What is your City and State?
This will require a minimum 10-char response from the user when given
this question. The prefix is automatically stripped; the default minimum
response is 0.
This door should work on networks. (I'm assuming using Prokit takes care
of all that file sharing stuff).
Distribution
------------
Please freely distribute this package to other PCBoard's that might
desire to have this style of new user registration. No registration
fee is required from free access BBSes. However, a donation is
requested from subscription BBSes. I suggest $25.
Source is available for those who donate. Be sure to contact me
if there's some customization you'd like to see for this door and
I'll tailor it for your BBS.
DJ Chuang (BBS and address - valid thru August '89, when lease is up)
Extraordinaire
(301)737-0342
300/1200/2400 bauds
3005 Sayre Drive
Great Mills, MD 20634
The author can also be reached at: (for you high-speeders)
Southern Maryland Christian Info Service
(301)862-3160
300/1200/2400/19200 USR HST
SM1 Revision History
--------------------
v 0.80 - Initial working release for SM1 registration door
v 0.81 - Place all user answers in one text file called SM1.LOG
v 0.82 - Fix a minor bug so when user presses return to the "agree?" prompt,
they will be forced to answer Y or N
v 0.83 - OOPS! Sorry.. rules screens were scrolling off without a query
to see if users agree. 0.82 didn't work as expected.
PLUS, now visiting sysop questionnaire answers are logged to
a separate file named SM1SYSOP.LOG in addition to being logged
to SM1.LOG.
And is now checking for dropped carrier and F8 to users during
questionnaire (it used to throw the door in an infinite loop -
not good).